RUANGSEKOLAH — PUSAT KENDALI KEPALA SEKOLAH
Versi 3.2

ISI PAKET
- Aplikasi web responsif untuk telepon, tablet, dan komputer.
- Modul operasional sekolah, tindak lanjut, supervisi, rapat, kesiswaan, kalender, sarpras, anggaran internal, surat, GTK, laporan, dan modul khusus.
- Upload gambar dan berkas pada catatan kerja.
- Ekspor tabel ke Word (.docx), Excel (.xlsx), PDF, CSV; ekspor/pulihkan cadangan JSON.
- Pengaturan warna RGB, tema, kerapatan, lebar halaman, radius kartu, dan modul dashboard.
- Login, pembuatan akun, konfirmasi password, reset password memakai data akun sekolah.
- Server bersama, SQLite, sinkronisasi berkala lintas perangkat, dan dukungan kerja offline pada perangkat yang pernah login.

MENJALANKAN DI KOMPUTER SEKOLAH
1. Pasang Python 3.10 atau lebih baru pada komputer yang akan menjadi server.
2. Ekstrak seluruh ZIP ke folder permanen.
3. Windows: klik dua kali start_server.bat. macOS/Linux: jalankan ./start_server.sh.
4. Pada komputer server, buka http://localhost:8080/BUKA%20APLIKASI.html.
5. Pada perangkat lain di jaringan lokal, gunakan alamat IP komputer server dengan port 8080, misalnya http://192.168.1.20:8080/BUKA%20APLIKASI.html.
6. Buat akun sekolah sekali. Masuk memakai akun yang sama di perangkat lain.

Jika BUKA APLIKASI.html dibuka langsung tanpa server, aplikasi tetap bisa membuat akun perangkat dan digunakan secara lokal. Akun dan datanya tersimpan hanya di browser/perangkat tersebut; jalankan server sebelum membuat akun untuk kerja bersama lintas perangkat.

AKSES ONLINE DARI LUAR SEKOLAH
Agar bisa diakses lintas jaringan, pasang server ini pada VPS/hosting yang mendukung Python atau Docker, aktifkan HTTPS melalui reverse proxy, dan set RUANGSEKOLAH_SECURE_COOKIE=1. Arahkan domain ke server tersebut. Jangan membuka port internet tanpa HTTPS. Data bersama disimpan di SQLite pada folder data; sertakan folder itu dalam backup rutin.

DOCKER
Dari folder aplikasi, jalankan: docker build -t ruangsekolah .
Lalu jalankan: docker run -d --name ruangsekolah -p 8080:8080 -v ruangsekolah-data:/data ruangsekolah
Untuk internet publik, gunakan reverse proxy HTTPS dan set cookie aman pada layanan.

ONLINE / OFFLINE
Aplikasi menyimpan perubahan lokal terlebih dahulu. Setelah koneksi pulih, perubahan akan disinkronkan ke server dan perangkat lain. Login offline tersedia pada perangkat yang pernah berhasil masuk. Jika aplikasi dibuat tanpa server, akun perangkat hanya berlaku di browser tersebut dan tidak tersinkron ke perangkat lain. Pasang sebagai aplikasi dari browser setelah membuka lewat HTTP/HTTPS. Service worker memerlukan HTTPS untuk domain publik; localhost diizinkan browser.

AKUN DAN PEMULIHAN
Reset password menggunakan email, nama sekolah, dan nama kepala sekolah yang terdaftar. Tidak ada kode keamanan yang ditampilkan saat pembuatan akun.

BATAS DAN CATATAN
- Lampiran maksimal 750 KB per berkas, 4 berkas per catatan, dan total 2,5 MB untuk seluruh aplikasi.
- Login demo tidak disediakan; buat akun sekolah saat pertama dibuka.
- Data sensitif siswa harus dilindungi melalui HTTPS, kontrol akses perangkat, backup terenkripsi, dan kebijakan retensi sekolah.
- Aplikasi membantu alur kerja internal dan tidak menggantikan Dapodik, ARKAS, e-Rapor, atau layanan resmi pemerintah.
- Word dan Excel diunduh dalam format DOCX/XLSX; PDF dibuat langsung dari data tabel.
